Troubleshooting Upgrade Problems

Problem	Solution
After upgrade, Ektron does not load properly. Also, an error icon appears next to your templates when you open the project in Visual Studio.NET, as illustrated below. The problem is that your .NET references need to be updated.	To verify the problem, open the Ektron solution file in Visual Studio.NET (webroot\siteroot\cms400sitename.sln; for example, cms400Intranet.sln) and look at the template files. If your references are broken (as shown in the sample screen on the left), delete all Ektron references. Then, add new references with the same name from the webroot\siteroot\bin folder.
When viewing a page containing Ektron server controls or API calls, the page returns a fatal error Compiler failed with Error Code 2000. Detailed compiler output may say Fatal error BC2000: compiler initialization failed unexpectedly: The filename, directory name, or volume label syntax is incorrect. This error message might appear after an upgrade.	See Ektron Knowledge Base article “ERRMSG: Compiler failed with Error Code 2000” (http://dev.ektron.com/kb_article.aspx?id=2029)
After upgrading from Ektron version 4.8 or earlier, Metadata is no longer applied or required when adding or editing content.	In Ektron version 4.8 or earlier, Metadata is applied globally. In later versions, metadata is applied to each folder individually. Child folders can inherit the metadata from a parent folder or they can have their own metadata settings. To set the metadata settings back to global, follow these steps. In the Workarea, click the site root folder. Next, choose View > Folder Properties. Click Edit Properties. Click the Metadata tab. Check the all of the appropriate check boxes for Assigned and Required Metadata. Click Save. If you have not broken inheritance on any of the folders, your metadata settings are applied globally. See Also: Working with Metadata

Problem

Solution

After upgrade, Ektron does not load properly. Also, an error icon appears next to your templates when you open the project in Visual Studio.NET, as illustrated below.

The problem is that your .NET references need to be updated.

To verify the problem, open the Ektron solution file in Visual Studio.NET (webroot\siteroot\cms400sitename.sln; for example, cms400Intranet.sln) and look at the template files.

If your references are broken (as shown in the sample screen on the left), delete all Ektron references. Then, add new references with the same name from the webroot\siteroot\bin folder.

When viewing a page containing Ektron server controls or API calls, the page returns a fatal error Compiler failed with Error Code 2000.

Detailed compiler output may say Fatal error BC2000: compiler initialization failed unexpectedly: The filename, directory name, or volume label syntax is incorrect.

This error message might appear after an upgrade.

See Ektron Knowledge Base article “ERRMSG: Compiler failed with Error Code 2000”

(http://dev.ektron.com/kb_article.aspx?id=2029)

After upgrading from Ektron version 4.8 or earlier, Metadata is no longer applied or required when adding or editing content.

In Ektron version 4.8 or earlier, Metadata is applied globally. In later versions, metadata is applied to each folder individually. Child folders can inherit the metadata from a parent folder or they can have their own metadata settings.

To set the metadata settings back to global, follow these steps.

In the Workarea, click the site root folder.
Next, choose View > Folder Properties.
Click Edit Properties.
Click the Metadata tab.
Check the all of the appropriate check boxes for Assigned and Required Metadata.
Click Save.

If you have not broken inheritance on any of the folders, your metadata settings are applied globally.